home *** CD-ROM | disk | FTP | other *** search
/ Amiga Tools 3 / Amiga Tools 3.iso / grafik / xipaint / hhsxipaintmod.readme < prev    next >
Encoding:
Text File  |  1995-09-21  |  9.7 KB  |  235 lines
  1. HHsFastUniversalXiPaintModule 2.0 (incl. PhotoCD-support)
  2. =============================
  3.  
  4. -> New: Now direct module suport for XiPaint 3.2 and up <-
  5.  
  6. This universal module can be used to quickly load images in many
  7. file formats (more than 20 and additionally Datatypes) very
  8. quickly into XiPaint 3.x. The way to use this module depends
  9. on your version of XiPaint:
  10.  
  11. 1) XiPaint 3.2 or higher
  12.  
  13. Just copy the module "hhsxipaintmod.xio" to the XiPaint/Modules
  14. directory. The module will then be detected by XiPaint 3.2
  15. as "HHsUniversalLoader" which you can then select in the Settings/Loaders
  16. list of loader modules. The Loader will be automatically used
  17. (if selected) for Opening of new projects and for loading into
  18. existing projects. Please note that it is currently not possible
  19. to load bigger pictures into smaller projects. By the way: The
  20. included ARexx script (ending with .rx) is not needed for
  21. XiPaint 3.2 or higher.
  22.  
  23. 2) XiPaint 3.0/3.1
  24.  
  25. As thoose XiPaint versions have no special support for external
  26. modules, the way of access to the module is a bit inconvenient.
  27. It can be started by an ARexx script (included) from XiPaints
  28. Macro/Execute menu. It will then switch to the WB screen and
  29. display a standard file requester. You can then select a file
  30. for loading (see below for supported file formats). The picture
  31. will be loaded if possible and transferred to XiPaint as a new
  32. project window. Then the WB screen is sent back so that
  33. XiPaint screen should appear in front again. Some XiPaint versions
  34. add absolute path names of new project windows to the relative
  35. standard path. I can't work around this, so such pictures will
  36. get wrong project names with such versions (Only use SaveAs to
  37. save such pictures). Please upgrade to XiPaint 3.2 to get a
  38. more convenient access to my module...
  39.  
  40. There are currently no error requesters (if a file can not be
  41. loaded nothing will happen).
  42.  
  43. If you register for the XiPaint modules you will receive a
  44. keyfile together with the latest version of the modules. The
  45. keyfile will enable you to use future demo versions as update.
  46.  
  47. The demo version will load all pictures in greyscales, but usually at
  48. the same speed as the full version would do in color.
  49.  
  50. Supported file formats for loading:
  51.  
  52. * IFF-ILBM (all standard formats 1 to 8Bit, EHB, HAM6, HAM8, 24Bit)
  53. * PhotoCD (Base format 768x512 or 512x768 (portrait); linear 24Bit colors)
  54. * PPM/PGM/PBM (P1&P4 b&w, P5 grey, P6 color)
  55. * QRT (also known as dump format by PD raytracers as POV-Ray)
  56. * Targa (RLE compr.&uncompr. 1/8/15/16/24/32Bit;incl. interleaved)
  57. * PCX (compr.&uncompr. EGA1-4Bit, VGA 8Bit grey/Colormap and 24Bit)
  58. * MacPaint (b&w compressed 1Bit format; datafork only)
  59. * BMP (uncompr. 24Bit RGB,1Bit,4Bit or 8Bit Colormap; RLE compressed 8Bit,1Bit)
  60. * TIF (packbit-compr./uncompr. Motorola formats 24Bit RGB, 1-8Bit grey/Colormap)
  61. * EGS7.x window iconification file format
  62. * DEEP (compr.&uncompr. 24Bit and 32Bit)
  63. * RGB formats (RGB8, RGBN, RGB5)
  64. * ACBM formats (1 to 8Bit, incl. HAM6/HAM8)
  65. * FBM formats (8Bit grey/color and 24Bit)
  66. * IFF-PBM (DPII) format
  67. * Sun raster (1Bit, 8Bit grey/color and 24Bit uncompressed)
  68. * YUV (color 1:1:1, 2:1:1, 4:1:1 and greyscale)
  69. * VLAB raw (color 1:1:1, 2:1:1, 4:1:1 and greyscale)
  70. * HHsYUVSq sequence format (sequential or random access)
  71. * HHsXRL formats (1-8Bit ColorMap incl. HAM6/8, 8Bit grey, 24Bit RGB compressed)
  72. * binary-EPS bitmaps (RGB and CMYK; this function is experimental)
  73. * TBCPlus frames (maybe also fields; this is untested)
  74.  
  75. * DataType (incl. first frame of animations with Anim-Datatypes)
  76.  
  77. Installation and Usage:
  78.  
  79. 1) XiPaint 3.2 and up
  80.  
  81. Please copy the file ending with ".xio" to the XiPaint/Modules directory.
  82. The file ending with ".rx" is not needed.
  83. Use the module by selecting it in the Settings/Loader list as
  84. HHsUniversalLoader and then by using the usual Load or Open functions.
  85.  
  86. 2) XiPaint 3.0/3.1
  87.  
  88. Please copy the file ending with ".xio" into the main directory of XiPaint.
  89. Please copy the file ending with ".rx" into the XiPaint/Makro directory.
  90. You can then use the module by calling the Makro from within XiPaint
  91. (menu Macro, subentry Execute). So to load a file with the module into
  92. XiPaint 3.0/3.1 you do not use the usual load function but instead call
  93. the macro.
  94.  
  95. The demo version will load all pictures in greyscales only, but at the
  96. same speed as the full version would do in colour.
  97.  
  98. The fast loading functions have all been written by me in assembler and
  99. optimized for fastest speed. I did this for my famous shareware programs
  100. *** CyberShow *** (universal viewer for all OS3.x Amigas and esp. for
  101. Cybergraphics users), *** EGSPhotoAlbum Professional *** (picture management
  102. and presentation software for EGS) and *** EGS-TV Professional ***
  103. (sequence/animation editing, framegrabber (VLab/IV24) and Blue Screen
  104. Keying software for EGS). When new formats are implemented for my other
  105. programs (or the speed is improved further), I will usually also update
  106. the modules, which registered user can then use due to the keyfile concept.
  107.  
  108. Registration
  109. ============
  110.  
  111. You can register for the modules at the small add-on price of only 8US$ or
  112. 10DM if you order one of my other shareware programs, e.g. CyberShow, the
  113. universal viewer and slideshow program for all Amigas with at least OS3.0
  114. (loading the same formats as the Fast Modules and additional JPeg and
  115. offering True/HighColor support with Cybergraphics) or EGSPhotoAlbum or
  116. EGS-TV. Just include the extra amount with your order for one of thoose programs
  117. and specify your XiPaintModule order on the registration form. Demo versions
  118. of the programs should be available at the same places where you got this demo
  119. or at least on Aminet (incl. CDs) or on the Actual Tools and Demos CD from
  120. ADX (Hamburg).
  121.  
  122. Otherwise you should use the supplied registration form to register.
  123.  
  124. If you only want to register for the modules, the registration fee is
  125. 18US$ outside europe or 20DM in europe. You will also get the latest demo
  126. versions of my other programs.
  127.  
  128. If you are already a registered user of one of my programs and now want to
  129. register for the modules, the registration fee is 13US$ outside europe or
  130. 15DM (in europe). This includes the latest versions of my programs as update.
  131.  
  132. (Special note for users in germany only: Wenn Sie schon registrierter Benutzer
  133.  eines meiner Shareware-Programme sind und sich Ihre Anschrift nicht
  134.  geändert hat, können Sie die Module direkt per Überweisung bestellen.
  135.  Als Verwendungszweck geben Sie bitte "XiPaintMod für ...." an, wobei Sie
  136.  das Programm was Sie schon haben und die Registriernummer angeben.
  137.  Zusätzlich möglichst auch noch Name/Anschrift; die Bankverbindung:
  138.  Konto-Nr. 5740147 BLZ 310 500 00 Stadtspark. Mönchengladbach)
  139.  (No bank transfers from outside germany!)
  140.  
  141. Send your filled in registration form together with cheque, international
  142. postal money order or banknotes to:
  143.  
  144.                         Helmut Hoffmann
  145.             Rubensstrasse 4
  146.             D-41063 Mönchengladbach
  147.  
  148.             Germany
  149.  
  150. You can currently also contact me by EMail (e.g. for suggestions):
  151.  
  152.         hhoff@pool.informatik.rwth-aachen.de
  153.  
  154. No registrations by EMail! If you want to register, please write by ordinary mail
  155. to my address above.
  156.  
  157. My EMail address:
  158.  
  159.         hhoff@pool.informatik.rwth-aachen.de
  160.  
  161. Special Thanks
  162. ==============
  163.  
  164. My special thanks go to Mr. Thomas Dorn and Ossowski's Schatztruhe for
  165. providing me with XiPaint.
  166.  
  167. Disclaimer
  168. ----------
  169.  
  170. This software (program and documentation) is provided "as is" and
  171. comes with no warranty, either expressed or implied.
  172. The author is in no way responsible for any damage or loss that may
  173. occur due to direct or indirect usage of this software. You use
  174. this software entirely at your own risk.
  175.  
  176. Copyright and Distribution
  177. --------------------------
  178.  
  179. HHsFastUniversalXiPaintModule (module and documentation) is copyright by
  180.  
  181.                         Helmut Hoffmann
  182.             Rubensstrasse 4
  183.             D-41063 Mönchengladbach
  184.  
  185.             Germany
  186.  
  187. The demo version may be freely distributed and used as
  188. long as the following conditions are met:
  189.  
  190. 1) All files have to be kept together
  191.  
  192. 2) No file may be modified or crunched/packed.
  193.  
  194.    The only official way to distribute the demo packed is the
  195.    original xipaintmod.lha archive.
  196.    The modules may not be disassembled or analysed. The limitations
  197.    integrated in the demo version may under no circumstance be removed
  198.    or bypassed.
  199.  
  200. 3) Distributors may only charge for the duplication process (including media)
  201.    and not for the software. Theese charges may not exceed the following
  202.    limits: a) Demo on a PD-disk: 7$ (US-dollar) including
  203.               postage&packing (in Germany: 10DM)
  204.        b) Demo on a PD-CD-ROM: 40$ (US-dollar) including
  205.               postage&packing (in Germany: 60DM)
  206.        c) Demo on a BBS/Mailbox/ftp-site or other electronically
  207.               callable system: Maximum charge 3$ (US-dollar) (in Germany: 5DM)
  208.               for downloading
  209.    Anyway, it must be made explictly clear to the buyer, that he does not
  210.    pay for the modules (demo) itself but only for the duplication service.
  211.  
  212. 4) It is not allowed to distribute this demo with any commercial product
  213.    without a written permission by me. One exception is the distribution of
  214.    the demo version with products not exceeding the above price limits (e.g.
  215.    a cover-disk magazine for 7$ or less).
  216.  
  217.    The demo version may be included with XiPaint.
  218.  
  219. 5) The registered version may not be redistributed. It may only run on one
  220.    machine per registration. It is allowed to make a backup copy of the
  221.    original disk.
  222.  
  223. Version history
  224. ---------------
  225.  
  226. V0.1 (7th aug. 95): Prerelease for loading functions
  227. V0.2 (20th aug. 95): Prerelease for loading by ARexx script:
  228.             added Request option and screen switching functions
  229. V1.0 (15th sep. 95): First official release for use by Arexx script (usable
  230.             with XiPaint 3.x)
  231. V2.0 (21st sep. 95): First release with direct loader module support for
  232.             XiPaint 3.2 (just copy the .xio file into the
  233.             XiPaint/Modules directory and configure it as loader)
  234.  
  235.